home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / cdc.z / cdc
Text File  |  1998-10-20  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4. ccccddddcccc((((1111))))                                                                  ccccddddcccc((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cdc - change the delta commentary of an SCCS delta
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ccccddddcccc ----rrrrSID [----mmmm[mrlist]] [----yyyy[comment]] files
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _c_d_c changes the _d_e_l_t_a _c_o_m_m_e_n_t_a_r_y, for the SID (SSSSCCS IIIIDDDDentification
  16.      string) specified by the ----rrrr keyletter, of each named SCCS file.
  17.  
  18.      _D_e_l_t_a _c_o_m_m_e_n_t_a_r_y is defined to be the Modification Request (MR) and
  19.      comment information normally specified via the _d_e_l_t_a(1) command (----mmmm and
  20.      ----yyyy keyletters).
  21.  
  22.      If a directory is named, _c_d_c behaves as though each file in the directory
  23.      were specified as a named file, except that non-SCCS files (last
  24.      component of the pathname does not begin with ssss....)  and unreadable files
  25.      are silently ignored.  If a name of ---- is given, the standard input is
  26.      read (see _W_A_R_N_I_N_G_S) and each line of the standard input is taken to be
  27.      the name of an SCCS file to be processed.
  28.  
  29.      Arguments to _c_d_c, which may appear in any order, consist of _k_e_y_l_e_t_t_e_r
  30.      arguments and filenames.
  31.  
  32.      All the described _k_e_y_l_e_t_t_e_r arguments apply independently to each named
  33.      file:
  34.  
  35.           ----rrrr_S_I_D          Used to specify the _SCCS _I_Dentification (SID) string
  36.                          of a delta for which the delta commentary is to be
  37.                          changed.
  38.  
  39.           ----mmmm_m_r_l_i_s_t       If the SCCS file has the vvvv flag set (see _a_d_m_i_n(1)]
  40.                          then a list of MR numbers to be added and/or deleted
  41.                          in the delta commentary of the SID specified by the
  42.                          ----rrrr keyletter _m_a_y be supplied.  A null MR list has no
  43.                          effect.
  44.  
  45.                          MMMMRRRR entries are added to the list of MRs in the same
  46.                          manner as that of _d_e_l_t_a(1).  In order to delete an
  47.                          MR, precede the MR number with the character !!!! (see
  48.                          _E_X_A_M_P_L_E_S).  If the MR to be deleted is currently in
  49.                          the list of MRs, it is removed and changed into a
  50.                          ``comment'' line.  A list of all deleted MRs is
  51.                          placed in the comment section of the delta commentary
  52.                          and preceded by a comment line stating that they were
  53.                          deleted.
  54.  
  55.                          If ----mmmm is not used and the standard input is a
  56.                          terminal, the prompt MMMMRRRRssss???? is issued on the standard
  57.                          output before the standard input is read; if the
  58.                          standard input is not a terminal, no prompt is
  59.                          issued.  The MMMMRRRRssss???? prompt always precedes the
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccddddcccc((((1111))))                                                                  ccccddddcccc((((1111))))
  71.  
  72.  
  73.  
  74.                          ccccoooommmmmmmmeeeennnnttttssss???? prompt (see ----yyyy keyletter).
  75.  
  76.                          MMMMRRRRssss in a list are separated by blanks and/or tab
  77.                          characters.  An unescaped new-line character
  78.                          terminates the MR list.
  79.  
  80.                          Note that if the vvvv flag has a value (see _a_d_m_i_n(1)),
  81.                          it is taken to be the name of a program (or shell
  82.                          procedure) which validates the correctness of the MR
  83.                          numbers.  If a non-zero exit status is returned from
  84.                          the MR number validation program, _c_d_c terminates and
  85.                          the delta commentary remains unchanged.
  86.  
  87.           ----yyyy[_c_o_m_m_e_n_t]    Arbitrary text used to replace the _c_o_m_m_e_n_t(s) already
  88.                          existing for the delta specified by the ----rrrr keyletter.
  89.                          The previous comments are kept and preceded by a
  90.                          comment line stating that they were changed.  A null
  91.                          _c_o_m_m_e_n_t has no effect.
  92.  
  93.                          If ----yyyy is not specified and the standard input is a
  94.                          terminal, the prompt ccccoooommmmmmmmeeeennnnttttssss???? is issued on the
  95.                          standard output before the standard input is read; if
  96.                          the standard input is not a terminal, no prompt is
  97.                          issued.  An unescaped new-line character terminates
  98.                          the _c_o_m_m_e_n_t text.
  99.  
  100.      Simply stated, the keyletter arguments are either (1) if you made the
  101.      delta, you can change its delta commentary; or (2) if you own the file
  102.      and directory you can modify the delta commentary.
  103.  
  104. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  105.           cdc -r1....6 -m"bl78-12345 !bl77-54321 bl79-00001" -ytrouble s....file
  106.  
  107.      adds bl78-12345 and bl79-00001 to the MR list, removes bl77-54321 from
  108.      the MR list, and adds the comment ttttrrrroooouuuubbbblllleeee to delta 1....6 of s....file.
  109.  
  110.           cdc -r1....6 s....file
  111.           MRs? !bl77-54321 bl78-12345 bl79-00001
  112.           comments? trouble
  113.  
  114.      does the same thing.
  115.  
  116. WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  117.      If SCCS filenames are supplied to the _c_d_c command via the standard input
  118.      (---- on the command line), then the ----mmmm and ----yyyy keyletters must also be used.
  119.  
  120. FFFFIIIILLLLEEEESSSS
  121.      x-file    (see _d_e_l_t_a(1))
  122.      z-file    (see _d_e_l_t_a(1))
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ccccddddcccc((((1111))))                                                                  ccccddddcccc((((1111))))
  137.  
  138.  
  139.  
  140. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  141.      admin(1), delta(1), get(1), help(1), prs(1), sccsfile(4).
  142.  
  143. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  144.      Use _h_e_l_p(1) for explanations.
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.